home *** CD-ROM | disk | FTP | other *** search
/ Java Developer's Companion / Java Developer's Companion.iso / documentation / tutorial / example / DelayedSoundArea.java < prev    next >
Encoding:
Java Source  |  1997-07-13  |  4.2 KB  |  124 lines
  1. /*
  2.  * Copyright (c) 1995-1997 Sun Microsystems, Inc. All Rights Reserved.
  3.  *
  4.  * Permission to use, copy, modify, and distribute this software
  5.  * and its documentation for NON-COMMERCIAL purposes and without
  6.  * fee is hereby granted provided that this copyright notice
  7.  * appears in all copies. Please refer to the file "copyright.html"
  8.  * for further important copyright and licensing information.
  9.  *
  10.  * SUN MAKES NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY OF
  11.  * THE SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
  12.  * TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
  13.  * PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SUN SHALL NOT BE LIABLE FOR
  14.  * ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
  15.  * DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES.
  16.  */
  17. /*
  18.  * @(#)DelayedSoundArea.java    1.3 95/10/13  
  19.  *
  20.  * Copyright (c) 1994-1995 Sun Microsystems, Inc. All Rights Reserved.
  21.  *
  22.  * Permission to use, copy, modify, and distribute this software
  23.  * and its documentation for NON-COMMERCIAL or COMMERCIAL purposes and
  24.  * without fee is hereby granted. 
  25.  * Please refer to the file http://java.sun.com/copy_trademarks.html
  26.  * for further important copyright and trademark information and to
  27.  * http://java.sun.com/licensing.html for further important licensing
  28.  * information for the Java (tm) Technology.
  29.  * 
  30.  * SUN MAKES NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY OF
  31.  * THE SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
  32.  * TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
  33.  * PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SUN SHALL NOT BE LIABLE FOR
  34.  * ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
  35.  * DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES.
  36.  * 
  37.  * THIS SOFTWARE IS NOT DESIGNED OR INTENDED FOR USE OR RESALE AS ON-LINE
  38.  * CONTROL EQUIPMENT IN HAZARDOUS ENVIRONMENTS REQUIRING FAIL-SAFE
  39.  * PERFORMANCE, SUCH AS IN THE OPERATION OF NUCLEAR FACILITIES, AIRCRAFT
  40.  * NAVIGATION OR COMMUNICATION SYSTEMS, AIR TRAFFIC CONTROL, DIRECT LIFE
  41.  * SUPPORT MACHINES, OR WEAPONS SYSTEMS, IN WHICH THE FAILURE OF THE
  42.  * SOFTWARE COULD LEAD DIRECTLY TO DEATH, PERSONAL INJURY, OR SEVERE
  43.  * PHYSICAL OR ENVIRONMENTAL DAMAGE ("HIGH RISK ACTIVITIES").  SUN
  44.  * SPECIFICALLY DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY OF FITNESS FOR
  45.  * HIGH RISK ACTIVITIES.
  46.  */
  47.  
  48. import java.awt.Graphics;
  49. import java.applet.AudioClip;
  50. import java.net.URL;
  51. import java.net.MalformedURLException;
  52. import java.util.StringTokenizer;
  53.  
  54. /**
  55.  * This ImageArea Class will play a sound each time the user enters the 
  56.  * area. It is different from SoundArea in that it accepts a delay (in 
  57.  * tenths of a second) before it plays the sound. If the mouse leaves
  58.  * the area before the time delay, the sound is not played.
  59.  *
  60.  * This allows you to have one piece of audio when the button is "hit"
  61.  * via SoundArea and another if the user stays on the button.
  62.  *
  63.  * @author     Chuck McManis
  64.  * @version     1.3, 13 Oct 1995
  65.  */
  66. class DelayedSoundArea extends ImageMapArea {
  67.     /** The URL of the sound to be played. */
  68.     URL     sound;
  69.     AudioClip    soundData;
  70.     boolean     hasPlayed; 
  71.     int            delay;
  72.     int        countDown;
  73.  
  74.     /**
  75.      * The argument is the URL of the sound to be played.
  76.      * This method also sets this type of area to be non-terminal.
  77.      */
  78.     public void handleArg(String arg) {
  79.     Thread soundLoader;
  80.     StringTokenizer st = new StringTokenizer(arg, ", ");
  81.     
  82.     delay = Integer.parseInt(st.nextToken());
  83.     try {
  84.         sound = new URL(parent.getDocumentBase(), st.nextToken());
  85.     } catch (MalformedURLException e) {
  86.         sound = null;
  87.     }
  88.     }
  89.  
  90.     public void getMedia() {
  91.     if (sound != null) {
  92.         soundData = parent.getAudioClip(sound);
  93.     }
  94.     if (soundData == null) {
  95.         System.out.println("DelayedSoundArea: Unable to load data "+sound);
  96.     }
  97.     }
  98.  
  99.     /**
  100.      * The highlight method plays the sound in addition to the usual
  101.      * graphical highlight feedback.
  102.      */
  103.     public boolean enter() {
  104.     hasPlayed = false;
  105.     countDown = delay;
  106.     parent.startAnimation();
  107.     return false;
  108.     }
  109.     public boolean animate() {
  110.     if (entered && ! hasPlayed) {
  111.         if (countDown > 0) {
  112.         countDown--;
  113.         return true;
  114.         }
  115.         hasPlayed = true;
  116.         if (soundData != null) {
  117.             soundData.play();
  118.         }
  119.     }
  120.     return false;
  121.     }
  122. }
  123.  
  124.